Skip to main content

Connecting with Close.com

The goal of this document​

Here, we are going to connect the vendor called Close with the Airbyte then it will redirect the data using the destination of MySQL to OPNBI, User can choose the format of the destination as required, For example from MySQL/ PostgreSQL, etc.

Useful Resources of Airbyte​

Requirements to get the ‘Close.com’ source​

• User should have an account on close.com if not then signup from the below link: https://app.close.com/signup/

• User should have the Personal Access Token of Close.com.

Steps to Fetch the Personal API Token from Close.com​

  1. To getch the Access Token of Close, you should go to https://app.close.com/settings/api/

  2. You need to login with your credentials.

  3. Find the 'settings' option from the left-vertical menu, click on that settings option.

  4. then find the 'API keys' option from the left-vertical sub-menu, as shown in the figure below:

    Docusaurus Slash Introduction

  5. Click on the New API key button from the top-right corner, as shown in the figure below:

    Docusaurus Slash Introduction

  6. Add API key name and click on the Create button from the bottom-right corner.

    Docusaurus Slash Introduction

  7. After clicking on create API key, it may take some time to generate the API key, then it'll display the API key as shown in the figure below:

    Docusaurus Slash Introduction

  8. Click on ok button to continue, after that the API keys will visible in grid:

    Docusaurus Slash Introduction

Steps to Connect Close.com with OPNBI​

  1. Go to the Airbyte using the below link: https://airbyte.com/

  2. The Airbyte landing screen looks like below:

Docusaurus Slash Introduction

  1. Here We have 3 options on the left, which contain Connections, Sources, and Destination. As per continuing the steps click on the Sources option.

Docusaurus Slash Introduction

  1. To add the Close.com source, click on the New Source button from the Top-right corner.

Docusaurus Slash Introduction

  1. To add Any of the sources here, the user needs to add the properties which are needed from the Airbyte, every source has its own individual properties.

Docusaurus Slash Introduction

note

Note: Here, every source demands a different type of property, where Client DI, Client Secret, and Refresh Tokens are common in most sources. on that we can say, all the sources are different from each other.

  1. Set up source Form overview:
  • Name: Users can add the name of the source as per their requirements.
  • Source Type: The user has to select the source type from the provided list by airbyte.
  • API key: Copy the API key form the vendor and simply paste here.
  • Start Date: You can add current date here.

Docusaurus Slash Introduction

  1. After adding the information, click on Set up Connection, it will test the connection here, then it will redirect to add destination of the source, as per figure below:

Docusaurus Slash Introduction

  1. After testing the connection successfully add the destination here.

Docusaurus Slash Introduction

  • Here, on the source adding screen,
  • The top-menu bar shows two buttons where
    1. for Overview of the source and
    2. for the settings of the source.
  • Overview: The overview screen shows the details related to the source; it may be empty as per the above screen.
  • Settings: From settings, the user can edit the form details of the added source.
  • Add destination button leads us to the destination page from the source page.
  1. Click on the Destination from the Top-right corner, as shown in the figure below:
note

It’s will show the available destinations, here user can add the new destination as per required.

Docusaurus Slash Introduction

info

To know more about adding the required destination in Airbyte go to the Destination

  1. Click on the MySQL Training here. it may take some time to fetch the stream names, as shown in figure below:

Docusaurus Slash Introduction

  1. After loading all the Streams form the Vendor’s to the destination, the destination page looks as shown in the figure below:

Docusaurus Slash Introduction

  1. After loading all the data streams user need to add Sync frequency and Table Prifix, as shown in the figure below:
  • Add Sync Frequency: Every Hour
  • Add Table Prefix: close_ 'It's an optional field, where users can add prefix just to recognize the table name easily.'
  • As shown in the figure below:

Docusaurus Slash Introduction

• When the user add the prefix, it gets added on Destination stream name automatically, as shown in the figure below:

Docusaurus Slash Introduction

  1. At the bottom of the destination page, we have two radio buttons, which contain the Normalization option. Keep the Basic Normalization selected.

Docusaurus Slash Introduction

  1. Now, click on the setup connection button to complete the connection. it will test the connection again which may take some time.
  2. Now, to validate the data is synced by the Airbyte, Go to the Connection from the Left menu bar of the screen:

Docusaurus Slash Introduction

  1. Find the Added connection of the close from the list,

Docusaurus Slash Introduction

Here, to see the Data synced, click on the row to see the details.

  1. Here the close.com connection page will show the Status of the data sync and sync history.

Docusaurus Slash Introduction

  1. The title of the source and destination name.
  2. Status and settings page top menu bar.
  3. Enable button: from this button, the user can enable/disable the source from the destination.
  4. Reset your data and Sync button: the user can reset their data and only sync the updated data from the vendor.
  1. Click on the sync button to sync the data manually, after clicking on the sync button, it will start the process which will indicate the status under the history grid.
info

Once it gets completed it will indicate as the Succeeded under the history, as it will also indicate the size of data records number and time of sync. Here we have added the sync time as every hour, on that the Airbyte will sync the data in every hour automatically which will be shown as the figure below:

Docusaurus Slash Introduction